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Use of DANGER, WARNING, CAUTION, and NOTE 


This publication includes, DANGER, WARNING, CAUTION, and NOTE information where appropriate to point out safety 
related or other important information. 


DANGER Hazards which could result in severe personal injury or death 
WARNING Hazards which could result in personal injury 

CAUTION Hazards which could result in equipment or property damage 
NOTE Alerts user to pertinent facts and conditions 


Although DANGER and WARNING hazards are related to personal injury, and CAUTION hazards are associated with 
equipment or property damage, it should be understood that operation of damaged equipment could, under certain operational 
conditions, result in degraded process performance leading to personal injury or death. Therefore, comply fully with all 
DANGER, WARNING, and CAUTION notices. 


TRADEMARKS 
Advant, AdvaCommand, AdvaInform, and AdvaBuild are registered trademarks of ABB Asea Brown Boveri Ltd, Switzerland. 
AutoCAD and DXF are registered trademarks of Autodesk Inc. 
FrameMaker is a trademark of Frame Technology Corp. 
HP and all HP products described in this document are registered trademarks of Hewlett Packard Company 
IBM-PC is a trademark of IBM Corporation 
MOD 300 is a trademark of ABB Process Automation Inc. 
ORACLE and SQL*ReportWriter are registered trademarks of Oracle Corporation 
OSF/Motif is a trademark of The Open Software Foundation, Inc. 
UNIX is a trademark of AT&T 


NOTICE 


The information in this document is subject to change without notice and should not be construed as a commitment by ABB 
Industrial Systems AB. ABB Industrial Systems AB assumes no responsibility for any errors that may appear in this document. 


In no event shall ABB Industrial Systems AB be liable for direct, indirect, special, incidental or consequential damages of any 
nature or kind arising from the use of this document, nor shall ABB Industrial Systems AB be liable for incidental or 
consequential damages arising from use of any software or hardware described in this document. 


This document and parts thereof must not be reproduced or copied without ABB Industrial Systems AB’s written permission, 
and the contents thereof must not be imparted to a third party nor be used for any unauthorized purpose. 


The software described in this document is furnished under a license and may be used, copied, or disclosed only in accordance 
with the terms of such license. 


CE MARKING 
This product meets the requirements specified in EMC Directive 89/336/EEC and in Low Voltage Directive 72/23/EEC. 
Copyright © ABB Industrial Systems AB 1997. 
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AdvaBuild Document Builder is used to integrate documents into your Advant Station 500 
Series Engineering Station project database. The Document Builder is based on FrameMaker® 
from Frame Technology® Corporation, and it provides additional features to store documents in 
and extract documents from the AdvaBuild database. Additionally, the Document Builder 
provides a calling interface to other Builders such as Structure Builder and Plant Documentation 
Builder to open and print documents within the AdvaBuild framework. 


FrameMaker is a DTP (DeskTop Publishing) system, including a word processor, page 
designer, graphics editor, and book builder rolled into one package. You can use this versatile 
application to write simple one-page memos or to produce complex multi-chapter documents 
with imported graphics. FrameMaker capabilities and features include: 


° Full word processing power 

° Flexible page design 

° Graphics tools, with color 

° Book building and revision management 

° Professional color control 

° Stylized tables for organizing information 

° Conditional text for multiple versions of a document 
° Templates for standardized documents 

° Information links can be built in. 


This book provides instructions for operating the Document Builder together with other 
AdvaBuild basic functions such as Structure Builder, Template Builder, and Plant 
Documentation Builder. It does not describe the general functions of FrameMaker. It describes 
limitations due to the integration of FrameMaker into the AdvaBuild framework. See the 
FrameMaker Documentation for a general description of how to use FrameMaker. 
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1.2 Manual Organization 


This book is organized into chapters and sections as shown in Figure 1|-1. 


Chapter 
Configuration/ Runtime 
Introduction Installation A pication Operation Maintenance | | Appendices Index 
uilding 
General. General Design Not applicable Notapplicable Appendix A 
Information Considerations Overview 
Manual . Samer ABB Templates 
Organization Overiow 
Conventions Capacity & 
Related Performance 
Documentation Application 
Release Start-up 
History Application 
Terminology Procedures 
Product Configuration/ 
Overview Application 
Building Menus 
User Interface x 


Section 


Figure 1-1. Manual Organization 
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1.3 Conventions 


The following conventions are used throughout this manual for the presentation of material: 


° Words in proper names of screen elements (for example, the title in the title bar of a win- 
dow, the label for a field of a dialog box) are initially capitalized. 


° Names of keyboard keys are boldfaced. 


— Initial capital letters are used for the name of a keyboard key if it is labeled on the 
keyboard. For example, the Return key or <Return>. 


— Lowercase letters are used for the name of a keyboard key that is not labeled on the 
keyboard. For example, the space bar, comma key, and so on. 


—  Indescriptions, the word “key” is used in conjunction with its name. 
For example, pressing the Return key initiates the process. 


—  Intables and procedures, angle brackets replace the word “key.” 
For example, press <Return>. 


— A dash is used to indicate that you must simultaneously press several keys. 
For example, <Ctrl-C> indicates that you must hold down the Control key 
while pressing the C key. 


— The phrase “press and release” is used to indicate that you sequentially press 
several keys. 


° Names of push and toggle buttons are boldfaced. 


— Initial capital letters are used for the name of a push or toggle button labeled on 
the display. For example, the OK button. 


—  Indescriptions, tables and procedures, the word “button” is used in conjunction 
with its name. For example, pressing the OK button initiates the process. 


° Names of menus and menu items are boldfaced. 


— Initial capital letters are used for the name of menus listed in the menu bar. 
For example, the File menu. 


— Initial capital letters are used for the name of menu items. For example, to open 
a new window, choose New from the File menu. 


° System prompts/messages are shown in the Courier font, and user responses/input 
are in the boldfaced Courier font. For example, if you enter a value out of range, 
the following message is displayed: 


Entered value is not valid. The value must be 0-30. 


In a tutorial, you may be told to enter the string TIC132 in a field. The string is shown 
as follows in the procedure: 


TIC132 
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1.4 Related Documentation 


A complete listing of AdvaBuild Documentation is shown in Figure 1-2 and described below. 


Hardware Station AdvaBuild Basic Software Options Other 
Advant Station AdvaBuild AdvaBuild HP-VUE 
Hardware Release Document Builder User’s Guide 
Ref. Manual Notes User’s Guide 
AdvaBuild AdvaBuild ; , 
Engineering Diagram Builder ee aera, 
Methods for User’s Guide 
Master Systems 
Advant Station 500 Series EI Disar Builder HP-UX 
Engineering Station UsereGuide Installing 
User’s Guide Peripherals 
AdvaBuild AdvaBuild 
Object Type Display Builder 
Reference User’s Guide 
AdvaBuild 
Function Chart Builder 
User’s Guide 
Advalnform 
Report Writer 
Manuals 


Figure 1-2. Related Documentation 


Advant Station 515 Hardware Reference Manual or 

Advant Station 5201 Hardware Reference Manual. 

Consult the appropriate hardware reference manual for instructions regarding hardware 
setup and installation. 


Release Notes 

Release notes are included in the delivery file with AdvaBuild software. The release notes 
provide installation instructions for both initial and upgrade installations, information 
regarding changes that have occurred since the last release of the project, and so on. 


AdvaBuild Engineering Methods for ABB Master Systems 
This book describes the principles of object-oriented engineering with AdvaBuild. 


Advant Station 500 Series Engineering Station User’s Guide 

Consult this book for a general functional overview of the Engineering Station. This book 
also describes how to use the Structure Builder, Template Builder, Plant Documentation 
Builder, how to access Display Builder, Function Chart Builder and On-line Builder. 
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° AdvaBuild Object Type Reference Manual 
Object Type Reference manual provides information on how to configure the various 
database object attributes. 


° AdvaBuild Document Builder User’s Guide 
Documentation how to use the Document Builder, it includes template documentation as 
well. 


° AdvaBuild Diagram Builder User’s Guide 
Description how to design drawings and diagrams with AutoCAD, including definition of 
user defined symbols. It includes library information as well. 


° AdvaBuild Electrical Diagram Builder User’s Guide 
Contains a description of drawing support for function oriented electromechanical 
diagrams and layout drawings. 


° AdvaBuild Display Builder User’s Guide 


° AdvaBuild Function Chart Builder User’s Guide 
Contains a description of AMPL application programs configuration. 


° AdvalInform Reports Reference Manual 
Reference Manual for SQL*ReportWriter 


° AdvaInform Report Builder User’s Guide 
User’s Guide for building Reports with SQL*ReportWriter. 


In addition to the AdvaBuild software books, the FrameMaker documentation set contains 
printed manuals and on-line manuals which are also relevant: 


° Printed FrameMaker Manuals 


— Introducing FrameMaker 
Describes features and functions of FrameMaker. It includes samples of the kinds of 
documents you can create. 


— Getting Started 
Teaches the basic procedures and concepts you need to know before you start work- 
ing on your own documents. 


— Using FrameMaker 
Comprehensive guide to FrameMaker procedures. It is organized by tasks. 


— Quick Reference 
Contains abbreviated instructions for many tasks and lists keyboard shortcuts. 


— Installing Frame Products 
Explains how to install FrameMaker and set up licensing at your site. 
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° On-line FrameMaker Manuals 


1.5 Release History 


1.6 Terminology 


Release Notes 
Provides important last minute information on FrameMaker that could not be 
included in the printed manuals. 


What’s New 
Describes the new and changed features in this release of FrameMaker and directs 
you to further information. 


Managing Frame Products 
Information on adding fonts to FrameMaker, the files contained in the release, and 
FrameMaker scripts and environment variables. 


Changing Setup Files 
Explains how to customize FrameMaker and its environment. 


Using Frame Filters 
Information on converting a wide range of documents between FrameMaker and 
other applications. 


Using Frame Products on Multiple Platforms 
Describes how the UNIX, Macintosh, and Windows versions of FrameMaker differ. 


MIF Reference 
Explains the MIF text format, which allows FrameMaker to share information with 
other applications while preserving graphics, text, and formatting information. 


MML Reference 
Describes a markup language that you can use with any standard text editor to create 
simple FrameMaker documents. 


For details regarding the release history refer to the Advant Station 500 Series Engineering 
Station User’s Guide. 


For details regarding the terminology used within this document refer to the Advant Station 500 
Series Engineering Station User’s Guide. 
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1.7 Product Overview 


AdvaBuild software consists of a family of modules called Builders that are integrated into a 
framework as shown in Figure 1-3. The framework consists of three basic components: 


° User Interface 
° Common Database, and 
° Structure Builder. 


Other builders, for example, Template Builder, Plant Documentation Builder, and Document 
Builder, are integrated into this framework and are accessed via the Structure Builder. 


Structure Builder 


Plant 
Function || Template |/Document}} Diagram | | Electrical || Display ||Documen-]}} On-line 
Chart Builder Builder Builder Builder tation Builder 
Builder Builder 


Engineering Database 


Figure 1-3. AdvaBuild Software Frame Architecture 


Use the Document Builder to integrate documents into your project database. Documents are 
stored as objects of type TEXT in the project database. TEXT objects are file objects, that is, 
in addition to the attribute values, file objects have the document content stored in the database 
and also temporarily stored in a file in the UNIX file system within the project directory 
structure. How a TEXT object is represented in the tree presentation of the Structure Builder is 
shown in Figure 1-4. 
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Figure 1-4. TEXT Object in Structure Builder Tree Presentation 


Object ID 


Object Type 


Comment 


it 


The Structure Builder provides functions to insert, copy, rename, move, delete, and print 


TEXT objects. The Structure Builder also provides access to: 


° The document content of the TEXT object via the DOCUMENT view, which invokes the 


Document Builder (see Figure 1-5) 


° The attribute values of the TEXT object via the TEMPLATE view, which invokes the 


Template Builder (see Figure 1-6). 
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Figure 1-5. DOCUMENT View of TEXT Object 
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S AdvaBuild Template Builde ae 
File Edit View Link Quer Help 


LOAN_FLAG §j 


FILE_NAME 
STATUS 
DOC_TYPE 
DOC_DES 


Count: *1 <OSC><DBG> <Replace> 
Help Enter [Execute | List TEB Menu Show Exit Accept 
Query Query —_ Keys Cancel | Save 


Figure 1-6. TEMPLATE View of TEXT Object 


The Document Builder lets you modify the document content using standard FrameMaker 
functions. These functions include: 


Basic Functions 

— Opening, saving, and printing documents. 

Text Functions 

— Typing, importing, and reversing text in a document 
— Changing text properties 

— Using catalogs for fast, consistent formatting 

— Inserting and editing tables 

— Working with table formats and customizing tables 
— Finding and changing items in a document 

— Using the Spelling Checker, dictionaries, and Thesaurus 
— Referring the reader to other pages 

— Creating and formatting footnotes 


— Using variables for automatic placement of text. 
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° Graphics Functions 

— Creating objects with the FrameMaker drawing tools 

— Resizing and shaping objects and arranging them on a page 

— Using frames to anchor graphics to text 

— Using graphics created in other applications or captured from the screen 

— Using and printing spot and process color. 
° Page Design Functions 

— Designing pages and adding headers and footers 

— Using master pages and reference pages to customize page design 

— Creating newsletters and other multi-column documents with more than one text flow 
° Document Management Functions 

— Creating templates and updating from them 

— Creating document reports, managing document revisions, and comparing versions. 
° Specialized Document Functions 

— Maintaining multiple versions in one document. 
° Equation Functions 

— Creating mathematical expressions and equations 

— Changing the positioning, alignment, and fonts in equations and expressions 

— Transforming and evaluating mathematical expressions. 


The Template Builder provides functions to insert and delete TEXT objects, and to modify the 
attribute values of TEXT objects. 
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1.8 User Interface 


The Document Builder does not provide a separate user interface. The user interface to access 
the Document Builder is provided by the AdvaBuild basic functions Structure Builder, 
Template Builder, and Plant Documentation Builder. The user interface to edit the document 
content is provided by FrameMaker. 


1.8.1 User Interface of AdvaBuild Basic Functions 


The user interfaces of the AdvaBuild basic functions: 
° Structure Builder 

° Template Builder 

° Plant Documentation Builder. 


are described in the Advant Station 500 Series Engineering Station User’s Guide 


1.8.2 User Interface of FrameMaker 


The FrameMaker user interface is described in the FrameMaker documentation set. 
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Chapter 2 Installation 


2.1 General 


For details regarding the installation of the product, refer to the appropriate Advant Station 
Engineering Station Release Notes. 
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3.1 Design Considerations 


3.2 Document Builder Overview 
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The Document Builder is used to integrate documents into your project database 

(see Figure 3-1). Documents are stored as objects of type TEXT in the project database. 
TEXT objects are file objects and, in addition to the attribute values, file objects have the file 
content stored in the database and also temporarily stored in the UNIX file system within the 
project directory structure below: 


/proj/ProjectName/fil 


NOTE 


ProjectName is a unique name of a project and is presented as the object identifier 
of the top level Project object. 


The representation in the UNIX file system is extracted from the database when opening a 
TEXT object with the DOCUMENT view. A unique filename is associated with each TEXT 
object. This filename is generated automatically using the rule: 


ObjectInternalKey_TEXT.doc 


NOTE 


ObjectInternalKey is a unique, internal identifier of an AdvaBuild object. 
The ObjectInternalKey cannot be modified. 


This filename is stored in the attribute FILE_NAME of the TEXT object and is not changed 
during the lifetime of the object. 


The first time a TEXT object is opened with the Document view the file content is copied from 
an initial template named: 


text_open.doc 
located in directory: 


SC_BIN_CAPE_TXT. 


In addition to this initial template a print settings file is provided in the same directory named 
text_print.doc. 


This file contains specific print settings which are required to print the document using Structure 
Builder and Plant Documentation Builder. Both files may be adapted, but are available only 
once for an installation and cannot be different for every engineering project. If the initial 
template does not fulfill your needs, use standard FrameMaker functions to select a new 
template for a document. After selecting the new template, save the document with the filename 
associated with the object you want the template based on. 
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Initial File 
Directory: $C_BIN_CAPE_TXT 
Filename: text_open.doc 


TEXT Object 


Structure 
Initial File 


Builder 


OPEN Object 
(View: DOCUMENT) 


Project 
Database 


TEXT Object Extract 


Attributes Document 


Builder 
TEXT Object 
File Content 


Activate 


Read / Write FrameMaker 


Read / Write 
sg | FrameMaker 


TEXT Object 
File Content 


Working File 
Directory: /proj/ProjectName/fil 


Filename: ObjectInternalKey_TEXT.doc (read / write) 


Object InternalKey_TEXT_r.doc (read only) 


Figure 3-1. Document Builder Overview 
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NOTE 


The configuration of the Document Builder files text_open.doc and 
text_print.doc requires that you are logged in as user cape into the UNIX 
environment. This is necessary because only this user has the privileges to access 
the directory and the files. 


The configuration of the print settings file is valid for the complete installation! 


NOTE 


Only the actual FrameMaker file (extracted and stored by the Document Builder) 
can be worked on. All other OPEN FILE activities for further TEXT Object files, 
started directly from FrameMakers main menu are not under control of the 
Document Builder and must not be overwritten. 

All further FrameMaker activities are not under control of the Document 
Builder! 


When you edit the contents of a TEXT object, if you want the modifications stored in the 
database, close the document and exit FrameMaker completely. The UNIX file system 
representation is not deleted after the document is stored. The next time you open the same 
object, the file stored in the database is compared to the file in the UNIX file system. The file 
with the newest modification date is opened. If the file on the UNIX file system was deleted by 
some event it will be extracted out of the database. 


During work on the object’s file content, the file is locked in the database. If a locked object is 
opened with the Document view this will be performed in read-only mode; that is, modifications 
on the file content will not be stored in the database. The filename for read-only files is 
generated automatically using the rule: 


ObjectInternalKey_TEXT_r.doc 


The file system representation of TEXT objects opened read-only will be deleted after you exit 
FrameMaker. 


3.2.1 Access Rights 


Users of group READER have only read privileges for TEXT objects. 
Users of group CONFIG are able to modify or create TEXT objects. 


3.2.2 Limitations to FrameMaker 5 Features 
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Using FrameMaker 5 integrated into the AdvaBuild framework means some FrameMaker 
features are not supported. These limitations are: 


° Only files in Editable Maker Format are stored in the database 


° Only one single file can be stored in the database; that is, you cannot build FrameMaker 
Book files which tie several files together 


° Generated lists (like Table of Contents) and indexes (like Standard Index) are not 
supported 


° Hypertext links and Cross References are not supported between different TEXT objects. 
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3.3 Capacity and Performance 


3.3.1 FrameMaker 5 Memory Allocation for Images and Fonts 


For details about the configuration of FrameMaker 5 see the FrameMaker on-line manuals: 
° Changing Setup Files 


° Managing Frame Products. 


NOTE 


For the configuration of X Window System resources create your private resource 
file Maker in the directory: ${HOME}/fminit/xresources. You can copy the file 
from ${FMHOME}/fminit/xresources/Maker and modify it to your own needs. 


When you open a document containing imported images (such as bitmap and EPSI files), Frame 
products do not immediately read all the images into memory. Instead, Frame products read 
each image only when you display or print. In the process, they remove from memory those 
images they no longer need. 


When a Frame product starts, it allocates a memory buffer to hold the screen representation of 
imported images. The buffer also holds font information and screen images of anchored frames. 
If you’re editing documents with many imported images, different font sizes, or different font 
families, or if you are zooming documents, you can improve the product’s performance by 
specifying a larger buffer or allowing more images to be stored in the buffer. 


To get out of trouble with bitmaps increase the following memory allocation X-Resources 


Resource: Old Value: 
Maker.maxClientBitmaps: 256 256 
Maker.clientBitmapSize: 4000000 600000 
Maker.maxServerBitmaps: 128 128 
Maker.serverBitmapSize: 4000000 1000000 


3.4 Application Start-up 


To start up the Document Builder, you must first log in to HP-UX, and then log in to a specific 
project with the Structure Builder. The Structure Builder then comes up with the tree 
presentation window and displays the PROJECT object as the root object. 


You can navigate through the structure with the Structure Builder to the desired TEXT object 
and open the DOCUMENT view on the TEXT object to start up the Document Builder. 


For more details on how to log in to HP-UX and to a specific project refer to the Application 
Start-up section of the Advant Station 500 Series Engineering Station User’s Guide. 
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3.5 Application Procedures 


These section provides general guidelines for basic application procedures. All application 
procedures involving Structure Builder, Template Builder and Plant Documentation Builder are 
described only in the required level of detail within this document. If you need further 
information regarding specific features provided by these Builders, refer to the Advant 

Station 500 Series Engineering Station User’s Guide 


3.5.1 How to Insert TEXT Objects in the Project Database 


3.5.1.1 Insert using Structure Builder 


You can insert as tree objects or as list objects into the project database using Structure Builder. 


Insert Tree Object 


Object id | =1K18&PBF6 | 
Comment | Plant Data List SubPlant* | 


[3 On same level 


Object type 


Figure 3-2. Insert Tree Object Dialog Box in Structure Builder 


To insert TEXT object using Structure Builder in tree or list presentation: 


ds 


Se Bo NS 


Select the desired parent object in the Structure Builder tree or list window. 
Choose Insert from the Structure Builder Edit menu. 

Select Object type TEXT from the selection box. 

Edit the Object id and Comment field. 

Click the OK button. 


The TEXT object is inserted into the tree or list presentation and has no document content until 
the TEXT object has been opened once with the Document view. The TEXT object attributes 
are set up with default values. 
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3.5.1.2 Insert using Template Builder 


You can insert TEXT objects as list objects into the project database using Template Builder. 


_ AdvaBuild Template Builder sie 
file Edit. “View! ‘kink ‘Query: Help 


LOAN_FLAG §j 


FILE_NAME 
STATUS 

DOC_TYPE (ETE SS ess 
DOC_DES (gigs 


Count: *1 <OSC><DBG> <Replace> 
Help Enter [Execute | List TEB Menu Show Exit Accept 
Query Query hay Keys Cancel | Save 


Figure 3-3. Single Object Form in Template Builder 


To insert a TEXT object using Template Builder: 

1. Choose Insert from the Template Builder Edit menu. 
2. Edit the Object id and the attribute values. 

3. Click on the Accept/Save button. 


The TEXT object is inserted as list object and has no document content until the TEXT object 
has been opened once with the Document view. 
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3.5.2 How to Copy TEXT Objects 


3.5.2.1 Copy using Structure Builder 
When you copy TEXT objects completely using Structure Builder: 
° All attribute values are copied. 
° The attribute FILE_NAME is adapted. 


° The document content in the database is copied. 


Copy Object 
[2 On same level 
[i Copy only single object 


©} Substitute mode 


& Mask mode 


Old object id =1K16&PBF6 


Old object comment —— Plant Data List SubPlant 1K18 


Substitute canunent aA by al 
Mask new comments | | 


Figure 3-4. Copy Object Dialog Box in Structure Builder 


To copy a TEXT object using Structure Builder: 
1. Choose Copy from the Edit menu. 

2. Fill in the Copy Object dialog box. 

3. Click on the OK button. 


Only the database representation of the TEXT object is copied. If changes are made to the file in 
the UNIX file system, and the data is not restored into the database, these changes are not 
copied. 
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3.5.2.2 Copy using Template Builder 


You can copy TEXT objects using Template Builder, but only the attribute values are copied and 
the attribute FILE_NAME is adapted. The document content is not copied (neither in the 
database nor in the file system). The status of the TEXT object remains the same after it is 
inserted. The objects are inserted in list presentation only, and are not visible within tree 
presentation. 


File Edit View Link 


TEXT File Attributes Page 1 of 2 


LOAN OBJ_IO FILE_NAME STATUS 


P 


<OSC><DBG> <Replace> 


: #1 
Help Enter [Execute | List Pp TER | Menu | Show | Exit | Accept 
Query Query a Keys Cancel | Save ] 


Figure 3-5. Multiple Object Form in Template Builder 


To copy a TEXT object using Template Builder: 

1. Choose Copy Single from the Template Builder Edit menu. 
2. Edit the OBJ_ID field and the attribute values. 

3. Click on the Accept/Save button. 
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3.5.3 How to Rename TEXT Objects 


You can rename TEXT objects using Structure Builder. Renaming objects does not affect the 
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attribute values and the document content in the database. 


Rename Object 


[2 Rename only single object 


©} Substitute mode 


& Mask mode 


Old object id =1K18&PBF6 


i 


Old object comment —— Plant Data List SubPlant 1K18 


Siistiiude comment [ hy ol 
Mask new comments | | 


Figure 3-6. Rename Object Dialog Box in Structure Builder 


To rename a TEXT object using Structure Builder: 
1. Choose Rename from the Edit menu. 

2. Fill in the Rename Object dialog box. 

3. Click on the OK button. 


The TEXT object in the database is renamed to the new object id. 
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3.5.4 How to Move TEXT Objects 


You can move TEXT objects within the structure using Structure Builder. Moving objects does 
not affect the attribute values and the document content in the database. 


Move Object 


[3 On same level 


Figure 3-7. Move Object Dialog Box in Structure Builder 


To move a TEXT object using Structure Builder: 
1. Choose Move from the Edit menu. 

2.  Fillin the Move Object dialog box. 

3. Click on the OK button. 


The TEXT object in the database is renamed to the new object id. 


3.5.5 How to Delete TEXT Objects 


You can delete TEXT objects using Structure Builder or Template Builder. 


Do you want to delete the selected object(s) 


? 


and the whole subtree if exists ? 


Figure 3-8. Delete Object Dialog Box in Structure Builder 


To delete a TEXT object using Structure Builder or Template Builder: 
1. Choose Delete from the Edit menu. 


2. Depending on whether you are using the Structure Builder or the Template Builder, do one 
of the following: 


a. Click the Yes button in the Delete Object dialog box of the Structure Builder. 
b. Click the Accept/Save button in the Template Builder. 


The TEXT object in the database and in the file system is removed. 


3-10 3BSE001980R0201 


AdvaBuild® Document Builder User’s Guide 
Section 3.5.6 How to Edit TEXT Objects 


3.5.6 How to Edit TEXT Objects 


3.5.6.1 Editing the Attributes 
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Editing TEXT object attributes, in this context, means to edit the values of TEXT object 
attributes as they are defined for the object type TEXT. The following attributes are defined: 


° FILENAME 


Represents the physical file name of the TEXT object within the file system. This value is 
generated automatically following the rule: 


ObjectInternalKey_TEXT.doc 


and is only displayed for information purposes. 
¢ STATUS 

Represents a status field which may be used freely. 
¢ DOC_TYPE 


Represents the document type. The document type, combined with the object type, is used 
as a key by the Plant Documentation Builder to generate Plant Documentation Packages, 
including specific document types. To display the valid values, click the List button in the 
Template Builder. Refer also to the current configuration of the Plant Documentation 
Builder. 


¢ DOC_DES 


Represents the document kind classification code for the document type corresponding to 
DIN/IEC. For valid values refer to the current configuration of the Plant Documentation 
Builder. 


To edit the TEXT object attributes using the Template Builder: 
1. Double-click on the desired TEXT object. 
2. Select the TEMPLATE view from the Open Objects dialog box in the Structure Builder. 


Template Builder is started and the object-type-related template is displayed. You can now use 
the standard Template Builder functions to edit the attributes of the TEXT object. 


The attributes DOC_TYPE and DOC_DES must have correct values before you print the 
document using the Plant Documentation Builder. 
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3.5.6.2 Editing the Document Content 


Opening the DOCUMENT View on a TEXT Object 


To edit the document content of a TEXT object, you must open the DOCUMENT view on the 
TEXT object from the Structure Builder: 


1. 


3. 


Double-click on an existing TEXT object. 
The Open Object dialog box is displayed, Figure 3-9. 


Open Object 


Views 


DOCUMENT 


TEMPLATE 


Selected view 


DOCUMENT, 


Figure 3-9. Open Object Dialog Box in Structure Builder 


Select the DOCUMENT view and click the OK button. 
or 

Click on an existing TEXT object. 

Choose Open from the Object menu. 

The Open Object dialog box is displayed. 

Select the DOCUMENT view and click the OK button. 


The range of Document Builder activities includes: 


3-12 


Extracting the document content of the selected TEXT object to an Editable Maker Format 
file in the file system, and 


Calling FrameMaker with the selected document to modify. 
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Two FrameMaker windows are displayed, the main window, Figure 3-10, and the document 
window, Figure 3-11. The document window presents the actual document content. 


IT 


HELP | INFO 


a [Body] 
Db 8 eh 8s 8H 18,9 Oe, 194, 1612 18, 199.20, |S 
es = cs cs cs vi 


Flow: A; Body 


Figure 3-11, FrameMaker Document Window 


Opening the DOCUMENT View the First Time on a TEXT Object 


The first time a TEXT object is opened with the Document view, the file content is copied from 
an initial template: 


text_open.doc 
located in directory: 


SC_BIN_CAPE_TXT. 


This file may be adapted but is available only once for an installation and cannot be different for 
every engineering project. If the initial template does not meet your needs, you can select other 
templates using standard FrameMaker functions. 
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Opening the DOCUMENT View Twice on the Same TEXT Object 


During the work on a TEXT object with the DOCUMENT view, the object is locked in the 
database. If a locked object is opened with the DOCUMENT view this open will be performed 
in read-only mode; that is, modifications on the file content will not be stored in the database. 
The filename for read-only files is generated automatically using the rule: 


ObjectInternalKey_TEXT_r.doc 


The file system representation of TEXT objects opened read-only will be deleted after you exit 
FrameMaker. 


Information Dialog 


ENC:1001: Object =1K18&PBF6 is opend for READ ONLY access! 
3, Changes to file /projimas1/fil/i992_TEXT_r.doc 
will not be stored back to data base! 


Figure 3-12. Information Dialog for Files Opened Read Only 


Closing a Document and Exiting FrameMaker 

When you have finished editing a document and want the document content saved, you must: 
° Save your document. 

° Close the FrameMaker document window. 

° Exit FrameMaker. 

To close the document and exit FrameMaker: 

1. Choose Save from the File menu to save the document content in the file system. 

2. Choose Close from the File menu to close the current document window. 


3. Click the Exit button in the main FrameMaker window. 


| FrameMaker — Alert 


@ ok to exit intemational FrameMaker? 


Figure 3-13. FrameMaker - Alert Window 


4. — Click the OK button in the FrameMaker - Alert window. 
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If you do not completely exit FrameMaker, that is, you close your document but the main 
FrameMaker Window continues to run: 


° The document content is not stored 


° One more FrameMaker license is still reserved. 


3.5.7 How to Print TEXT Objects 


3.5.7.1 Print using FrameMaker 
Before you print a document, check with your system administrator to determine: 
° If your system is set up to print 
° The logical name of “your” printer. 
To print a document: 
1. Open the desired TEXT object. 
2. Choose Print from the FrameMaker File menu. 


This displays the FrameMaker - Print dialog box, Figure 3-14. 


Print 
Print Page Range: 
| all © Start Page: [1] End Page: fr _—| 


Printer Paper Size: Mi Odd- Numbered Pages 
i Even-Numbered Pages 


wat 
I Collate 
Height: C Last Sheet First 


0 Low- Resolution Images 


Copies: [I] Scale: C1 Registration Marks 
Printer Name: O Thumbnails - - Rows: z_] Cols: 


O Manual Feed 


O Print Only to File: |/projfmas1/fil/1992_TEXT.ps 


O Print Separations 


Figure 3-14. FrameMaker Front-Out Dialog Box 


3. Fill in the FrameMaker - Print dialog box. If the name in the Printer Name text field does 
not match your printers logical name, change it. For more details on this function see the 
FrameMaker documentation. 


4. Click on the Print button. 


5. Close the document and exit FrameMaker. 
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3.5.7.2 Printing using Structure Builder 


Printing a TEXT object via Structure Builder will create a PostScript file. This file will be stored 
within the specified directory or directly sent to the standard PostScript printer queue. To print a 
TEXT object using the Structure Builder: 


1. Click on the desired TEXT object. 
2. Select Object from the menu bar of the Structure Builder. 
3. Choose Print from the Object menu. 


This displays the Print Object dialog box, Figure 3-15. 


Print Object 


21 print only to file | PlantDataList_1K18, | 


Views 


DOCUMENT 


Selected view 


DOCUMENT 


Figure 3-15. Print Object Dialog Box in Structure Builder 


4. Fill in the Print Object dialog box. 
You can select between two print modes: 


Print only to file: 

Select the print only to file check button and give the print file name in the text entry box. 
Do not specify any extension to the print file name because the extension “.ps” will be 
added automatically. Together with the file name you can also specify the directory where 
the print file will be stored: 


— The default directory for print files is: 
/proj/ProjectName/usr/UserName 


— An absolute directory specification (for example: /proj/test/doc/myfile) 


-— A relative directory specification (for example: ../../doc/myfile). The directory you 
specify will be relative to the default directory. 
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Print directly to the standard PostScript printer queue: 
You reach this mode by not selecting the print only to file check button. The standard 
PostScript printer queue is ps represented by the environment variable C_LPRINT_POST. 


Select the DOCUMENT view 


and click the OK button. 


3.5.7.3 Print using Plant Documentation Builder 


You can print a number of TEXT objects automatically within a Plant Documentation Package 


using the Plant Documentation Buil 


der. For more information see the section on Plant 


Documentation Builder in the Advant Station 500 Series Engineering Station User’s Guide. 


NOTE 


The attributes DOC_TYPE and DOC_DES must have correct values before you 


print the document from a Pl 
Documentation Builder. 


ant Documentation Package using the Plant 


a AdvaBuild Plant Documentation Builde 


File View Oocument Quer Help 


Count: *5 


<OSC><DBG> <Replace> 


Help Enter [Execute } L 
Query Query 


ist AdvaBuild Pl} Menu Show Exit Accept 
byt: ser] Keys Cancel | Save 


Figure 3-16. Genera 


te Plant Documentation Package Window in 


Plant Documentation Builder 


All print files of TEXT objects are stored as PostScript files within the directory: 
/proj/ProjectName/doc 


The print file names are given as: 


DocumentKindClassificationCode_ObjectInternalKey_TEXT.ps 


where the original file name of the TEXT object was: 


ObjectInternalKey_T! 


EXT.doc 


and are sent immediately to the sele 


cted printer queue. 
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3.5.8 How to Use Further Templates 
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If you do not want to use the initial template loaded by Document Builder, you can select 
another template using the standard FrameMaker functions. See the Framemaker documentation 
for further information. 


The ABB templates provided with your Document Builder are listed in the Appendix. You can 
also check for possible templates provided with your FrameMaker installation. 


You can select a new template for the TEXT object by following these steps: 
1. Double click on the desired TEXT object. 
2. Select DOCUMENT view from the Open Object dialog box and click the OK button. 


This opens the main FrameMaker window and the FrameMaker document window, which 
displays the actual file content of the TEXT object, Figure 3-17. Note the file name of the 
TEXT object and close the FrameMaker document window. 


a 


File Edit Format View Special Graphics Table Help 


BE) ki 
it] 1 iq 3,44 5 6.42 3 9 1g! 1 1 1441 1617, (18, 199,29 
t t t t * 
f | 
F Wer iar all rigs inhic document andinthe simeatoncsrbinedtioaetn Reproduction, use or dzcloguretothid parties withouexpress 
B pcos iain pe dill ai tia Rastahay tear OH eee ae RY : 
: 1.} Choose Variable frorn the Special menu.] : 
3 : 2.) In the Varidble dblog box, select the user variable you want. to change and click Edit Def-: 
: inition (the user variables appear in alphabetical oder after the system variables).{| : 
4 3.}In the Definition text box, type the text of the variable (delete the space first). : 
5 4.}To change another variable, xlecta variable in the User Variables scroll list, and start : 
: again at step 3.7 . 
6 : 5.} Click Done (in both dialog boxes). J] 
: To delete this text] : 
? : Put the insertion point in the text, choose Select All in Flow from the Edit command thaupyess | 
: Delete.{] 7 
9 


Figure 3-17. FrameMaker Document Window with TEXT Object File Name 


3. Select New... from the main FrameMaker window. 
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Select the desired template from the FrameMaker - New dialog box and click the Create 
button. 


New 
Use Blank Paper: 


[ errar] [Eantscape] [Easton] | 


Use Template: 


wf (Go up 1 directory level) 
ABBtemplates3.0-0/ 


fusriframe4/fminit/ukenglish/Maker/Templates 
7 Directories, 0 Files 


Gea 


Figure 3-18. FrameMaker - New Dialog Box 


This displays a new FrameMaker document window which shows the template’s contents. 
Initially, the name of the document is NoName, as shown in Figure 3-19. 


Figure 3-19. FrameMaker Document Window without File Name 
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5. Select Save As... from the File menu of the FrameMaker document window. 


This displays the FrameMaker - Save Document dialog box, Figure 3-20. 


FrameMaker — Save Document 


Save Document 


Save in File: Format: 


wf (Go up 1 directory level) 
1965_TEXT doc Pernissions: 
Group: Mi Read 
i Write 
Public: Mi Read 
O write 
{projimas1 /fil 
1 Directory, 6 Files 


Figure 3-20. FrameMaker - Save Document Dialog Box 


6. Edit the previously noted file name of the TEXT object in the Save in File: text field, select 
Format Normal, and click the Save button. 


This displays the FrameMaker - Alert dialog box, Figure 3-21. 


FrameMaker — Alert. 


@ ok to overwrite existing file 1992_TEXT.doc? 


Figure 3-21. FrameMaker - Alert Dialog Box 


7. Click the OK button in the FrameMaker - Alert dialog box. 


The content of the TEXT object is overwritten by the content of the new template. 
The filename is updated in the window frame of the new FrameMaker document window. 


8. Close the FrameMaker document window with the new template and exit FrameMaker. 


The file based on the new template is stored in the data base. 
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3.5.9 How to Import Existing Documents 


You can import existing documents into your project database from either a floppy disk or any 
other directory of the file system. 


See Advant Station 500 Series Engineering Station User’s Guide for details on how to use the 
floppy disk drive of your Advant Station. 


If you open an existing FrameMaker document or a document created in a compatible 
application, FrameMaker tries to take the information in the file and convert it to a FrameMaker 
document in editable Maker Format. The file formats FrameMaker can open directly are: 


° Editable Maker Format (file extension “.doc’’) 


° Maker Interchange Format (file extension “.mif*‘). See the on-line manual MIF Reference 
for more information. 


° Maker Markup Language Format (file extension “.mml“). See the on-line manual MML 
Reference for more information. 


° Text Format (file extension “.txt“). See the on-line manual Using Frame Filters for more 
information. 


If the file is from another application, a filter for that application must be used to convert the file 
before FrameMaker can open the file. For more information on FrameMaker filters see the on- 
line manual Using FrameFilters. 


If the file is from a different platform, such as Windows or Macintosh, see Using Frame 
Products on Multiple Platforms for more information. 


You can import existing documents by: 
1. Copy the existing FrameMaker file into the following directory on the Advant Station. 
/proj/ProjectName/fil 
where Project Name is the target project name. 


2. If required, convert the file format using a filter provided with your FrameMaker 
installation. See the on-line manual Using Frame Filters for more information. 


3. Insert a TEXT object in the project structure via the Structure Builder. 
4. Open the Document view of the TEXT object. 


5. Continue in the same way as described in Section 3.5.8, How to Use Further Templates 
except that, instead of using New... from the main FrameMaker window, use Open... to 
open the existing document. 
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3.5.10 How to Use Demo FrameMaker 
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With the Special Command “SHOWTEXT” for objecttype “TEXT”, it is possible to open a 
FrameMarker document (objecttype TEXT) for reading with Demo FrameMaker. For Demo 
FrameMaker exist no limit of licenses so you can open multiple texts at the same time. 

Demo FrameMaker has the same functionality as normal licensed FrameMaker, except that the 
function “Save” is not available. 


To start the Demo FrameMaker function select the “TEXT” object, choose the Structure Builder 
submenu entry Special Commands... under menu Object, then select item “SHOWTEXT” 
and press the OK button. The file will be extracted from the DataBase or from the working 
directory of the Document Builder to the “/tmp” directory. The name of the file will be the same 
as the object_id, so that only restricted names are allowed to use for “TEXT” objects. After 
creation of the file in the directory “/tmp” the Demo FrameMaker will start and open that file. 
After exit of Demo FrameMaker the file will not be deleted in the directory “/tmp”. 


With the Special Command “BROWSE” for objecttype “PROJECT”, it is possible to extract all 
FrameMaker documents (objecttype “TEXT’’) to the Filesystem with object_id as filename. 
Demo FrameMaker will start at the last extracted object and it is possible to browse through the 
File Open... menu of the Demo FrameMaker. 


To start this function select the “PROJECT” object, choose the Structure Builder submenu entry 
Special Commands... under menu Object then select item “BROWSE” and press the OK 
button. The files of all “TEXT” objects will then be extracted from the DataBase or from the 
working directory of the Document Builder to the “/tmp/text” directory. The name of the files 
will be the same as the object_id, so that only restricted names are allowed to use for “TEXT” 
objects. After the files are created in the directory “/tmp/text” the Demo FrameMaker starts and 
opens the last extracted file. After exit of Demo FrameMaker the files will not be deleted in 
directory “/tmp/text”. 
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3.5.11 How to Configure Document Builder 


3.5.11.1_ How to Configure FrameMaker 


For details about the configuration of FrameMaker, see the FrameMaker on-line manuals: 
° Changing Setup Files 


° Managing Frame Products. 


NOTE 


Please note that in the integrated version of FrameMaker the International (U.K.) 
English version is supported as default; that is, the U[Language is ukenglish. For 
the configuration of X Window System resources, create your private resource file 
Maker in the directory: ${ HOME}/fminit/xresources. You can copy the file from 
${ FMHOME }/fminit/xresources/Maker and modify it to your needs. 


3.5.11.2 How to Configure the Initial Template 
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The initial template is used by Document Builder every time you create a new TEXT object in 
the database and you open the DOCUMENT view of the newly created TEXT object for the first 
time. You may want to configure this template (for example, to define your company name in 
the document footer) or to substitute the template provided with one you prefer. 


NOTE 


The configuration of the initial template will affect the whole installation. 


To configure the initial Document Builder template you must edit the file: 


SC_BIN_CAPE_TXT/text_open.doc 


NOTE 
To configure this file you must be logged in as user cape in the UNIX 


environment. Only this user has the privileges to access the directory and the file. 
The following actions have to be executed: 
1. Change to directory: 


S$C_BIN_CAPE_TXT 


2. Start FrameMaker in an hpterm window and open the file 
text_open.doc 
3. Modify the initial template to your needs. 


4. Save the modification, close the document, and exit FrameMaker. 
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3.5.11.3 How to Configure the Print Settings File 


The print settings file is used by Document Builder when printing a document via Structure 
Builder or Plant Documentation Builder. 
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NOTE 


The configuration of the print settings file will affect the whole installation. 


To configure the print settings file of Document Builder you must edit the file: 


SC_BIN_CAPE_TXT/text_print.doc 


NOTE 


To configure this file you must be logged in as user cape in the UNIX 
environment. Only this user has the privileges to access the directory and the file. 


The following actions have to be executed: 


1. 


Change to directory: 


SC_BIN_CAPE_TXT 


Start FrameMaker in an hpterm window and open the file 
text_print.doc 


To modify the print settings, choose Print from the FrameMaker File menu to display the 
FrameMaker - Print dialog box. 


Modify the print settings to your needs (refer to Using FrameMaker for details about the 
print settings). 


Save the modified settings by clicking on the Save Settings Only button. 


NOTE 


Make sure you have selected the Print only to file button before you save the 
modified settings. This is required to perform correct printing via Structure 
Builder and Plant Documentation Builder. 


To save the modification back to the file, choose Save from the FrameMaker File menu. 


Close the document, and exit FrameMaker. 
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3.5.12 How to Upgrade the TEXT Object’s Document Content 


The document content of a TEXT object is converted automatically to the current FrameMaker 
version when you open the document with FrameMaker 5. The following alert box indicates 
that FrameMaker is opening a FrameMaker 4 document: 


Opening a release 4 document: 13448_TEXT.doc. 
OK to continue? 


This document will be converted to the current 
release. To keep the earlier version, use Save 


As to save this document with a different name. 


Figure 3-22. FrameMaker - Alert for Version 4 Documents 
Click the OK button and do not save the document with another name. 


NOTE 


To print out TEXT objects created with FrameMaker 3.x it is not required to 
upgrade the document content from version 4 to version 5. The conversion will 
only be performed if you open the TEXT object for modification. 


CAUTION 


You cannot use an earlier release of FrameMaker to open documents that you 
create with FrameMaker 5. 


For more details about upgrading from an earlier release of FrameMaker, see the manual 
Installing Frame Products. 


3.6 Configuration/Application Building Menus 


Document Builder does not provide a menu for configuration and application building. The 
relevant menus for editing the document content of TEXT objects are in FrameMaker. Refer to 
the FrameMaker documentation set for more information on the FrameMaker menus. 


All other functions required to handle TEXT objects in the AdvaBuild data base are 
provided by: 


° Structure Builder 
° Template Builder 
° Plant Documentation Builder. 


Refer to the Advant Station 500 Series Engineering Station User’s Guide for more information 
on the menus of these builders. 
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Chapter 4 Runtime Operation 


Not applicable. 
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Chapter 5 Maintenance 


Not applicable. 
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Appendix A Overview ABB Templates 


A.1 General 


The ABB templates provided with your Document Builder are located in the following 
directory: 
SFMHOME/fminit/ukenglish/Maker/Templates/ABBtemplates3.x-x 


Templates 


+——— ABBtemplates3.x-x 
t+ Book 

L——— Business 

t+——— Outlines 


-——— Reports 


i Special 
Figure A-1. Directory Tree of the Templates Directory 


The ABB templates are subdivided into: 
° Basic Templates 

— Delivery Documentation 

— Letter 

— Guidelines 

— Overhead 

— Memo 

— Manual 

— Telefax 

— Technical Documentation 


° User’s Manual. 


NOTE 


Templates provided as book files and the generated files like table of contents 
(*.TOC), list of figures (*.LOF), indexes (*.IX) and list of tables (*.LOT) cannot 
be used with the Document Builder. They can only be used with the stand-alone 
installation of FrameMaker. 
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